home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / getline.arc / GETLINE.DOC < prev   
Encoding:
Text File  |  1986-12-08  |  3.6 KB  |  73 lines
  1.                           Public Domain Program
  2.  
  3.       The  author, Ron Ginsberg, 4961 182nd Lane N.W., Anoka, MN. 55303, 
  4. submits  the  referenced  program  for  your  use at your own risk at no 
  5. charge  for its use, and does not accept any direct or implied liability 
  6. toward  its  users  for  any  and  all damages possibly occurring to any 
  7. apparatus,  program,  or  data,  etc.,  as  a result of using the entire 
  8. program  or any portion thereof. This program or any part thereof is not 
  9. to  be  sold but is intended to be distributed for media cost only where 
  10. applicable.  Parts  of  this  program  may  contain  segments  of  other 
  11. published  public  domain software. The author would appreciate comments 
  12. regarding bug fixes and improvements.
  13.  
  14.                             December 8, 1986
  15.  
  16.       This  is  beta-test  version  of  a  text  string  search  program 
  17. GETLINE.com.  This  will  search  an ASCII file for text on a line basis 
  18. (255   characters   per  line  maximum)  without  upper  or  lower  case 
  19. sensitivity.  It  also  pays  no attention to the eighth bit so Wordstar 
  20. format  files  (DATASTAR)  can  be  searched.  The  searched file is not 
  21. modified.
  22.  
  23. Syntax is:
  24.      GETLINE x:filename.ext word1 word2 word3 .....
  25. e.g.  GETLINE b:pcsig101.300 fin
  26.      will find lines containing finance, FINISH, Infinite ,etc.
  27.  
  28.      GETLINE b:pcsig101.300 term comm
  29.       will  find  lines  containing  term  communications,  not terminal 
  30. communications.
  31.  
  32.       Note  that  no quotes are around the key string. Wildcards are not 
  33. supported.
  34.  
  35.       I  just  modified this version to accept a filename (filename.fls) 
  36. which  contains  a  list  of  files  (one filename per line in the usual 
  37. format  --  pathing is supported) to be searched. This file of filenames 
  38. must  end  in the extension .FLS. When the program detects the extension 
  39. .FLS  in  the command line, it will read in the names from that file and 
  40. then  search  each  one  sequentially.  IT IS IMPORTANT TO NOTE that the 
  41. path  or  disk  drive  assignment  specified  in  the command line for a 
  42. filelist  file  is NOT PASSED to the individual file names in that file. 
  43. Therefore,  it  is  best  that  the  filelist file be placed in the same 
  44. subdirectory  and/or  disk  of  the  files to be searched, if practical, 
  45. with  that location made the current disk and directory, and the default 
  46. path set to the disk and subdirectory where getline is located.
  47.  
  48.       Alternatively,  each  line  in  the  filelist file can contain the 
  49. full drive and path specification. A typical filelist is shown below:
  50.  
  51.      (The file is named MSDOSCAT.FLS)
  52.          \PCSIG\PC-SIG1.100
  53.          \PCSIG\PC-SIG101.200
  54.          \PCSIG\PC-SIG201.300
  55.          \PCBLUE\PC-BLUE.CAT
  56.  
  57.       Up  to twenty lines of filenames may be placed in a filelist file, 
  58. each   line  containing  up  to  forty  characters.  Wildcards  are  not 
  59. supported.  In  the  example  shown,  the  command  GETLINE MSDOSCAT.FLS 
  60. FLIGHT  PLAN  would  search  the  three files in the PCSIG subdirectory, 
  61. then  the  file  in  the PCBLUE subdirectory for the text string "flight 
  62. plan"  and  display each line it finds. In this example only the current 
  63. disk is searched.
  64.  
  65. Hard  copy  output  to  a  file  or  printer  may be had as usual by the 
  66. redirection entry as the last parameter of the command line, thus:
  67.      GETLINE MSDOSCAT.FLS COMMUN >prn
  68. will  send  its  output to the printer instead of the screen. If GETLINE 
  69. is  called  as  a batch file line, then printer redirection will be lost 
  70. and  the  screen  echo  command  CNTRL-PRTSCRN should be used before the 
  71. batch file is activated.
  72.  
  73.